Module Xpetitions
=================

Module de ptitions en ligne multilangues dvelopp pour fonctionner avec le hack Smartfactory Multilanguages.
Les formulaires peuvent tre accompagns d'une vrification anti-spams CAPTCHA aux choix (3).

Vous pouvez crer autant de ptitions que vous le dsirez.

Chaque ptition peut possder 3 statuts :
* Active (La ptition peut tre signe si la date de dmarrage n'est pas suprieur  la date du jour)
* hors ligne (La ptition n'est pas visible et ne peut pas tre signe)
* Archive (La ptition est visible et consultable mais ne peut pas tre signe)

Une aide est prsente sur chaque page de l'admin pour vous aider avec les diffrentes options possibles.

Le module possde une feuille de style que vous pouvez modifier suivant vos chartes graphiques.

Les fonctionnalits du module (admin) :
- Cration de ptitions (table des signatures, titre, description, email de rponse, statut, date de dmarrage, document papier associ)
- Modification et suppression de ptitions
- Visualisation des signatures
- Extraction des signatures au format .csv
- Relance des signataires qui n'ont pas confirm leur signature
- Enregistrement manuel de signatures (signature par document papier)
- Suppression de signatures
- Prfrences avec multiples choix
- Blocks avec prfrences (dernires signatures, ptitions actives, ptitions archives)

Les fonctionnalit du module (client) :
- Barre de navigation dans les ptitions (paramtrable)
- Accueil du module avec rcap des ptitions et nombres de signatures associs (paramtrable)
- Accueil d'une ptition avec description et barre dynamique (paramtres variables : document associ tlchargeable, envoyer  un ami (oui ou non))
- Envoyez  un ami : formulaire avec image captcha si active et dynamique lorsque les champs sont remplis.
- Signature : formulaire avec image captcha si active et contrle de l'adresse email par script (5 niveaux de controle - voir fonction)
- Cration d'une cl MD5 (15 positions) pour la validation des signatures
- Visualisation des tous les signataires ou par ordre alphabtique


Fonctionnalits supplmentaires
===============================

- Prfrences : Validation des signatures par email ou par double click
- Prfrences : Type d'diteur au choix (pour la saisie des ptitions)
- Gestion des signatures : Validation force des signataires retardataires
- Gestion des emails : Modification des contenus des emails envoys aux signataires
- Gestion des champs : Gestion des champs visibles et obligatoires du formulaire de signatures des ptitions
- Gestion des captchas (NOUVEAU) : Gestion des captchas visibles dans vos formulaires
- Feuille de style : Modification des barres dynamiques des ptitions (clear: both)
- Formulaire de signature : Message dynamique suivant option choisie (Email ou Automatique)
- Signatures (visualisation) : Entre parenthses, affichage des informations slectionnes dans l'administration
- Signatures (visualisation) : Suppression de la dernire virgule aprs le dernier signataire de la liste


Installation du module
======================

Xpetitions s'installe comme tous les autres modules Xoops.
Vous devez copier le rpertoire /xpetitions dans le rpertoire des modules Xoops de votre site.
Ensuite identifiez vous comme administrateur, menu Systme admin -> modules puis dans les modules non installs, cliquez sur l'icne d'installation.
Puis, suivez les instruction qui suivent  l'cran.

Mettre le rpertoire /xpetitions/csv/ accessible en criture pour l'export des signatures (chmod 777).

Crer un rpertoire, dans le rpertoire upload de Xoops, (ex: /upload/xpetitions) accessible en criture pour le stockage des ptitions papiers qui vous associerez  vos ptitions en ligne.

Il y a un fichier 'mysql.en.sql' pour les utilisateurs Anglophone dans le rpertoire 'mysql'. Renommez ce fichier en 'mysql.sql' si vous souhaitez avoir les messages d'email en anglais.
Il y a un fichier 'mysql.it.sql' pour les utilisateurs Italiens dans le rpertoire 'mysql'. Renommez ce fichier en 'mysql.sql' si vous souhaitez avoir les messages d'email en italien.

Versions Xoops supportes
=========================

Le module Xpetitions a t test sur Xoops 2.5.5 (Versions supportes 2.5.x)


Langages
========

Le module est traduit en Franais, en Anglais et en Italien (Merci  Francesco).



Versions supportes PHP/MYSQL
=============================

Mysql >= 3.23, 4.x, 5.x Php 4 & 5



Feedback
========

Utilisez le site du dpot d'INFORMATUX:
https://github.com/informatux45/xpetitions